home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1997 May / macformat-050.iso / Shareware Plus / Developers / Find_icon folder / Headers / Get_normal_file_icon.h < prev    next >
Encoding:
C/C++ Source or Header  |  1997-01-25  |  1.7 KB  |  53 lines  |  [TEXT/CWIE]
  1. /*    ---------------------------------------------------------------------------------------------
  2.     Find_icon, code for constructing icon suites for files and folders
  3.     
  4.     by James W. Walker
  5.     preferred e-mail: <mailto:jwwalker@kagi.com>
  6.     alternate e-mail: <mailto:jwwalker@aol.com>, <jim@nisus-soft.com>
  7.     web: <http://users.aol.com/jwwalker/>
  8.     
  9.     File: Get_normal_file_icon.h
  10.     
  11.     Copyright ©1997 by James W. Walker
  12.     
  13.     You may incorporate this sample code into your applications without
  14.     restriction, though the sample code has been provided "AS IS" and the
  15.     responsibility for its operation is 100% yours.
  16.     If you're going to re-distribute the source, please make it clear
  17.     that the code was descended from James W. Walker's code,
  18.     but that you've made changes.
  19.     ---------------------------------------------------------------------------------------------
  20. */
  21.  
  22. #ifndef __TYPES__
  23.     #include <Types.h>
  24. #endif
  25.  
  26. #ifndef __FILES__
  27.     #include <Files.h>
  28. #endif
  29.  
  30. #ifndef    _H_MetaSelector_
  31.     #include "MetaSelector.h"
  32. #endif
  33.  
  34.  
  35. OSErr    Get_normal_file_icon(
  36. /* --> */    const CInfoPBRec    *cpb,
  37. /* --> */    MetaSelectorValue    icon_selector,
  38. /* <-- */    Handle    *the_suite
  39. );
  40. /*    ¶ Create an icon suite for a file that does not have a custom icon.
  41.     In most cases the icons will be obtained from the desktop database,
  42.     but in some cases they may come from the System or Finder.
  43.     
  44.     cpb                input:    A parameter block describing the file, which you have
  45.                             filled in by PBGetCatInfo.
  46.     icon_selector    input:    an icon type mask, as defined in <Icons.h>.
  47.                             You can also use the special masks in MetaSelector.h,
  48.                             for instance svLargeThenSmall means to first
  49.                             search for large icons, but if none are found,
  50.                             try for small icons.
  51.     the_suite        output:    The new icon suite.
  52. */
  53.